home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / AGATE / AGATE.DOX next >
Text File  |  1995-01-01  |  12KB  |  222 lines

  1. Formatted in 80 columns.
  2.  
  3. Documentation for AGATE:  Apple GrAphic TErminal         Release 003: 03-JAN-90
  4.                                                         Written by Tony Marques
  5.  
  6. (C) 1990 by Tony Marques.
  7.  
  8.  
  9.  
  10. Requirements for AGATE
  11.  
  12. - ProDOS 8 (recommended but any ProDOS should be fine).
  13. - An Apple IIgs, an Apple IIc or an Enhanced Apple IIe with a 128k or any
  14.   compatible with 128k and the 65c02 Machine Language Instruction Set.
  15. - a GSPort or a Superserial Card (or a compatible such as a DataLink Modem)
  16. - A Hayes Compatible Modem.
  17.  
  18.  
  19. Configuring AGATE
  20.  
  21. Choosing the interface.  Press ESCape to change the current modem interface
  22. selected.  After you have selected the correct modem interface, you may need
  23. to select the baud of your modem from The Option Menu.
  24.  
  25.  
  26. THE OPTION MENU
  27. The Option Menu is accessed by pressing OA-3 form the terminal.  You will
  28. usually wish to access the Option Menu whenever you start.  The Configurer is
  29. devided into three sections.  Pressing TAB will move through the sections will
  30. pressing escape will return you to the terminal.  Pressing OA-S will save the
  31. all the options to disk including the QuicKeys and the Phone List.
  32.  
  33. The Phone List
  34.  A telephone directory with 8 entries.  The up and down arrow keys scroll you
  35.  throught the list.
  36.  
  37.  You are able to add new numbers by entering the number with an optional
  38.  description within brackets () and then pressing Solid-Apple and the number of
  39.  the entry you where you would like to place the entry.  Start the phone number
  40.  with a 'P' to Pulse Dial or with a 'T' to Tone Dial (optional).  The number
  41.  may be as long as you wish but don't separate any  of the digits with spaces
  42.  and place any comments within brackets () after the number.
  43.  
  44.  Pressing Open-Apple and the number of one of the entries will dial that
  45.  number.  The computer will dial then wait until it detects a carrier.  If
  46.  none is detected after several seconds it will pause and then redial the
  47.  number after 60 seconds.  This redialing feature may be aborted by pressing
  48.  any key.
  49.  
  50. The Option List
  51.  This list allows you to set terminal emulation, Lines per Linefeed, Sound,
  52.  the Delete Key, and the Baud rate.
  53.  
  54. - AGATE currently 'emulates' DEC VT-100 a.k.a. ANSI.  It supports all the
  55.   common features of this terminal.  It also supports DEC VT-52.
  56. - AGATE Release 003 also now supports Proterm Special Emulation next to
  57.   perfectly, or so I think.
  58. - Lines per linefeed is a useful option because scrolling the graphic
  59.   screen is much slower than scrolling a text screen and an apparent speed
  60.   increase is possible by increasing the number of lines scrolled per feed.
  61.   You may never need this option especially on a IIgs but it's here.
  62. - Sound.  I wrote the entire program but I don't know what this does so why
  63.   don't you use your imagination.
  64. - The Delete key.  Not all BBS's recognize $7F (127) as delete so you might
  65.   want to change this option to BackSpace so that a Back Space (Left arrow)
  66.   is sent whenever the delete key is pressed.
  67. - Baud.  0300 Baud  1200 Baud  2400 Baud  4800 Baud  9600 Baud.
  68.   Refer to you modem to find out which it supports but the higher the baud
  69.   the faster so resort to the fastest possible (unless it's to fast for my
  70.   terminal to keep up which is by all means possible so if you are missing
  71.   characters choose a slower speed).
  72.  
  73.  
  74. The QuicKey List
  75.  AGATE as limited macro capabilities.  You can assign a up to 31 characters
  76.  to each letter in the alphabet.  The characters can include any symbol, letter
  77.  or number inaddition to the return key and to the higher end of the IBM
  78.  character set (press SA-Key).
  79.  
  80.  Pressing a letter will display the 31 character string assigned to that
  81.  letter.  The up and down arrow keys can also be used to scroll through
  82.  the alphabet viewing the assignments.  To edit a QuicKey display it's
  83.  letter and press return.  Enter the keystrokes you wish to assign it and
  84.  end by pressing escape.  Returns can also be included within QuicKeys.
  85.  
  86.  
  87. The Terminal Mode
  88. You will be in command mode when you first run AGATE.  This mode is basic to
  89. all modems, but some terminal programs sometimes shield the user from this
  90. mode (because you don't need to use it).  In command mode you are able to enter AT commands which tell the Modem what to do.  For a list of these commands
  91. refer to your modem manual as it should contain the full set of instructions
  92. your modem accepts.  An example AT commands would be 'ATD' followed by a
  93. telephone number to dial.
  94.  
  95. Onces a number is dialed you will be in Terminal Mode where you are linked to
  96. a remote device such as a BBS.  From here you communicate with the remote
  97. device and anything you type in will be sent along the telephone line.
  98.  
  99. You are able access a review buffer/scrollback by pressing OA-Up Arrow.
  100. Several kilobytes have been devoted to preserve a copy of the text which
  101. appears on the screen during a session.  It will quickly scroll by but you can
  102. hold down any key to pause it.  Pressing ESC will abort the review and return
  103. you to terminal mode.
  104.  
  105. Pressing a letter in conjuction with a letter will display and send the
  106. appropriate  QuicKey.  You might have N be the QuicKey for your name and so
  107. that anytime you wish to type in your name you can just press OA-N instead.
  108.  
  109. * Do not have any passwords as QuicKeys since someone would only have to look
  110.   at your QuicKey list to find out your password(s).
  111.  
  112. You may press Open-Apple-? for a brief help screen and pressing Open-Apple-3
  113. will send you into the Option Screen.
  114.  
  115. * Do not change the Baud while on-line with a remote system.
  116.  
  117.  
  118. The Font Editor!!  New to Release 002 and a total of 8 Fonts new to Release 003
  119.  
  120. Now, I originally added the font editor after a noon's work and it is very basic.  You will be able to edit any of the 8 Fonts but I refer to the First four as the System Fonts but allow you to edit them anyway.  The fonts are as Follows:
  121.  
  122. #0  Normal  Used normally as normal characters
  123. #1  IBM     Used normally as Higher Characters
  124. #2  Tempo   Incomplete Tempo Character set which you will never access on-line!
  125. #3  Mouse   Used in conjunction with Proterm Special Emulation (Mouse Text)
  126. #4  Script  Alternate Font #1  Used as ANSI Color
  127. #5  Tech    Alternate Font #2  Used as ANSI Color
  128. #6  Small   Alternate Font #3  Used as ANSI Color
  129. #7  Copy    Alternate Font #4  Used as ANSI Color.  Copy of #0 Normal Font.
  130. You may do what everyou wish with the fonts but I would advise you to modify only fonts 4, 5, 6, 7.  Do NOT upload a copy of AGATE anywhere if you screw up the fonts...
  131.  
  132.  
  133. Release 003 may surprise Release 002 users when they look at the new display.  It is now a 27 row by 80 column display.  I plan on adding the option to choose different drivers so that the display size may be user-selectible on which I've already begun work.  You may someday have the option of a 40 column display or the use of text (gag...).
  134.  
  135.  
  136. Special Notes on IIgs
  137. In order to ensure speed and readability, AGATE constantly sets the system
  138. speed to FAST and the colors to MONOCHROME.  This is not done to the battery
  139. backed RAM so that you will not have to change the control panel if you wish to
  140. restore the options to previous values and any changes will only be in effect
  141. until
  142.  a) the computer is turned off.
  143.  b) the control panel is accessed.
  144.  c) another program changes the options.
  145.  
  146.  
  147. Quirks
  148. Small yet fun quirks I've left in my program from debugging stages.
  149.  
  150. OA-Ctrl-@  - set font to Normal   OA-Ctrl-H  - set font to Bold Normal OA-Ctrl-A  - set font to Script   OA-Ctrl-I  - set font to Bold Script
  151. OA-Ctrl-B  - set font to Tech     OA-Ctrl-J  - set font to Bold Tech
  152. OA-Ctrl-C  - set font to Small    OA-Ctrl-K  - set font to Bold Small
  153.  
  154. These have now been modified with the Release 003 and are different but still exist.  You may try pressing OA-Key with or without the Control or SA keys to try different typefaces.
  155.  
  156.  
  157. RELEASE 003
  158.  
  159. I've quickly gone over the Documentation to update users on Release 003.  Although Release 003 has no radical improvements or additions, it contains several enhancements which users may or may not notice which will serve as stepping stones to further greater enhancements.  I have allowed my self to work on several different parts of AGATE leaving them all unfinished so that I have unfortunately been unable to finish any single element.  But, I've relocated and am now centered in Vancouver so that I have access to other users and to BBS's (especially now that I have bought a modem, I didn't have one for previous releases), so this will aid me in development.  This release was slapped together to allow me to distrubute my program to a greater number of users as Release 002 was unavailible to me.  So, you are probably a user who was only been introduced to AGATE with Release 003 -- don't worry you haven't missed much.
  160.  
  161.  
  162. Future Plans
  163. - Downloading will soon be availible to AGATE users.  My current interface
  164.   supports only XModem and YModem but it fails to work with some BBS so I've
  165.   opted to not include it in the current release.
  166. - Uploading may come sometime afterwards, except for ASCII Uploading which
  167.   should be expected with any Downloading.
  168. - Supporting 4K-XModem and Streaming YModem (YModem-G).
  169. - Printer support (Imagewriters only?) can also be expected.
  170. - An on-line editor to compose those text messages and so forth.  I don't know
  171.   if I would be able to create something which could potentially be very
  172.   complex to write and make.
  173. - Expanded interface and modem support (as soon as they are requested and I
  174.   receive information concerting the particular item of hardware.)
  175. - Addition terminals emulated and more complete emulation of DEC VT-100.  (As
  176.   soon as their requested and I receive information concerning the emulation).
  177. - Revamped Option Menu and revamped QuicKeys.
  178. - Increased user friendliness.
  179. - Tempo Emulation (if no one else supports it I will) (contact Jeff Tupper).
  180. - Video Options to use different display types.
  181.  
  182. Those items above are those things which spring into mind when I foresee having
  183. some free time to devote to AGATE.  Some of the items are already next to
  184. finished others (such as a Text Editor) may take some time.
  185.  
  186.  
  187. Notes on Programmer
  188. Tony Marques shall continue to work on this program.
  189. He plans to release better and more improved versions and this is merely a
  190. Prototype, but he needs your help.  He needs information on Terminal emulators
  191. such as DEC VT100 (ANSI), DEC VT52, TeleType, IBM 3101, or any of the many
  192. others.  He is also looking for information on download protocols such as 
  193. XModem, YModem, ZModem, XYModem, WModem, Sealink, Kermit, and their variations.
  194. Those examples listed here are by no means all, if you have any information on
  195. those mentioned or any others contact
  196.  
  197.                 Tony Marques
  198.                 2602 Molitor Street
  199.                 Terrace, British Columbia
  200.                 Canada, V8G-3A2
  201.                 (602) 635-2724
  202.  
  203. You may also contact him to for support, to gather information (on TEMPO
  204. for instance) or if you have any suggestions, improvements, or modifications to
  205. AGATE.
  206.  
  207.  
  208.  
  209. * AGATE is CURRENTLY FreeWare, but I severely HOPE that I may get contributions
  210.   from people who like, enjoy, or otherwise respect my program.  A great deal
  211.   of effort and attention went into making AGATE.
  212.  
  213.  
  214.  
  215.                                      Sincerely,
  216.                                      Tony Marques
  217.                                      Person Responsible
  218.  
  219.  
  220. P.S.  If you find any quirks or bugs let me know, and if you find any unclear
  221.       sections in this document relay them to me.  All suggestions welcome.
  222.